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standardized  forms. 
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AUTOMATED  DATA  PROCESSING  SYSTEM  (ADPS): 


DOCUMENTATION  STANDARDS 


1 INTRODUCTION 


Purpose 

The  purpose  of  this  report  is  to  define  acceptable  documentation 
for  the  U.S.  Army  Corps  of  Engineers'  Computer  Aided  Engineering  and 
Architectural  Design  System  (CAEADS)  throughout  its  life  cycle.  Pro- 
posed standards  shall  apply  both  to  CAEADS  as  a system  and  to  each 
CAEADS  subsystem. 


Scope 


Many  other  factors  affect  documentation  worthiness,  including: 
unity,  coherence,  style,  attractiveness,  uniformity,  convenience,  thor- 
oughness, relevance,  and  content;  however,  these  were  not  considered  in 
this  report.  A broad  approach  to  standards  was  undertaken  to  cover  both 
technical  and  administrative  documents,  with  emphasis  placed  on  kinds  of 
documents  and  their  general  content. 


Background 


Over  the  last  quarter  century.  Automatic  Data  Processing  System 
(ADPS)  documentation  standards  have  evolved  to  provide  technical  and 
administrative  control  of  an  ADPS  life  cycle,  from  concept  through  dis- 
posal. A rapidly  growing  technology  and  increasingly  complex 
interaction  of  personnel  and  machines  has  required  a corresponding 
growth  in  documentation.  The  involvement  of  increasingly  larger  sums  of 
money  also  invites  controls. 

The  need  for  coordinated  standards  is  so  universal  that  the  govern- 
ment has  become  foremost  in  establishing  them.  Different  levels  of  gov- 
ernment have  different  responsibilities;  normally,  lower  levels  issue 
supplementary  guidance  to  implement  the  guidance  set  by  higher  author- 
ity. Consequently,  one  cannot  (and  should  not)  always  seek  a final 
answer  in  a single  set  of  issued  standards. 

Though  governmental  documentation  "standards"  exist,  the  documen- 
tation process  is  still  not  very  standardized.  Therefore,  other  poten- 
tial sources  of  guidance— the  standards  which  are  developing  in  the  com- 
mercial or  private  sector— should  not  be  overlooked. 
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One  drawback  of  published  standards  is  that  they  represent  thoughts 
which  prevailed  approximately  a year  before  publication.  As  a result, 
standards  may  lack  currency  and  consistency. 


Approach 

Significant  government  and  commercial  standards  were  reviewed  for 
applicability.  Government  levels  reviewed  were  Federal,  Department  of 
Defense,  Department  of  the  Army,  and  Corps  of  Engineers. 

Technical  documents  considered  were  both  the  more  commonly  cited 
documents  of  high  utility  and  the  less  frequently  mentioned  (but  as 
vital)  documents  of  limited  use.  Administrative  (or  management)  docu- 
ments encompassed  both  resource  management  (time,  funds,  manpower,  mate- 
riel) and  general  administration. 

The  body  of  this  report  is  divided  into  three  parts:  (1)  classi- 
fication or  categorization  of  standards,  (2)  examination  of  current 
standards,  and  (3)  forecasted  trends  of  future  standards. 


Mode  of  Technology  Transfer 

This  information  will  be  disseminated  in  accordance  with  procedures 
set  forth  in  AR  18-1,  Managp.ment  Information  Systems:  Policies,  Objec- 
tives, Procedures  and  Responsibilities  (Department  of  the  Army,  22  March 
1976). 


2 STANDARDS  CATEGORIES 


The  general  rule  of  standards  is  that  there  should  be  a specific 
document  for  each  specific  audience.  Following  is  a categorized  list  of 
standards,  grouped  by  type  of  use. 


Technical  Documents 
Frequent  Use 

Systems  Description  Manual 
Functional  User  Manual 
Program  Description  (Maintenance)  Manual 
Operators  Manual  (Run  Book) 

Infrequent  or  Single  Use 

General  Functional  System  Requirement 

Detailed  Functional  System  Requirement 

System/ Subsystem  Specification 

Program  Specification 

Data  Base  Specification 

Conversion  Manual 

Training  Manual 

System  Integration  Test  Plan 

Prototype  Evaluation  Test  Plan 


Management  Documents 


Resource  Management 


Project  Master  Plan 
System  Extension  Plan 

Funds 

Management  Information  System  Economic  Analysis 
Lease  Versus  Purchase  Analysis 

ADP  Contract  Services  Requirements  Approval  Request 
ADP  Resource  Estimating  Procedures 

Manpower 

Organization  and  Personnel  Plan 
Training  Plan/Manual /Package 
System  Extension  Plan 
ADP  Resource  Estimating  Procedures 
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Materiel 

Hardware  Specification  and  Justification 
ADP  Resource  Estimating  Procedures 

General  Administration 

General  Functional  System  Requi remen t 
System  Integration  Test  Report 
Prototype  Evaluation  Test  Report 
ADPE  Readiness  Review  Report 
System  Extension  Report 
System  Completion  Report 


3 CURRENT  STANDARDS 


General 

Table  1 lists  major  types  of  documentation  which  apply  both  to  the 
CAEADS  system  and  to  each  of  its  subsystems.  Some  lesser,  or  implied, 
items  have  been  omitted.  For  example,  a lease  versus  purchase  analysis 
(AR  18-1,  Appendix  L)  ordinarily  accompanies  an  Automatic  Data  Pro- 
cessing Equipment  (ADPE)  justification  (AR  18-1,  Appendix  J)  and  is  ref- 
erenced by  the  justification  documentation  requirement.  The  ADP  con- 
tract services  requirements  approval  request  (AR  18-1,  Appendix  N)  is 
not  cited.  Emphasis  has  been  placed  on  documentation  which  is  submitted 
to  higher  authority;  some  guidance  from  higher  authority  is  not  cited, 
e.g.,  DFSR  guidance  by  Office  Chief  of  Staff,  Army  (OCSA),  and  PMP  and 
ADPE  specifications  guidance  by  OCSA.  Only  Planning  and  Definition 
Phase  and  Development  Phase  documentation  are  of  immediate  interest. 

Table  1 contrasts  three  standards  which,  together,  are  reasonably 
comprehensive.  These  and  other  standards  of  interest  (see  References), 
are  discussed  individually  in  this  chapter.  Table  1 is  somewhat  sim- 
plified in  order  to  relate  three  sets  of  standards--Federal , Department 
of  Defense  (DOD),  and  Department  of  the  Army  (DA)--on  a single  page. 

The  DFSR,  AR  18-1,  Appendix  D,  is  shown  as  most  nearly  related  to  Figure 
2-02,  DOD  4120. 17M,  and  Section  3.2,  FIPS  PUB  38.  Actually,  the 
relationship  is  more  complex,  and  the  DFSR  of  AR  18-1  corresponds  to 
portions  of  Figures  2-02  through  2-05  of  DOD  4120. 17M  and  portions  of 
Sections  3.2  through  3.5  of  FIPS  PUB  38.  The  Appendix  to  this  report 
contains  a more  extensive  relationship  of  these  three  publications, 
their  similarities,  and  their  dissimilarities.  The  detail  of  the  Appen- 
dix is  limited  to  at  most  five  levels  (four  levels  below  the  document 
level).  The  Appendix  presents  all  Table  1 documents  through  the  devel- 
opment phase,  excepting  the  PET  Plan,  PET  Report,  SEP,  Training  Manual, 
and  ADPE  Readiness  Review  Report.  (The  ADPE  Readiness  Review  Report 
does  not  apply  to  CAEADS.) 


FIPS  PUB  38 

Federal  Information  Processing  Standard  (FIPS)  Publication  38, 
Guidelinee  for  Documentation  of  Computer  Programs  and  Automated  Data 
Systems,  prepared  by  the  National  Bureau  of  Standards,  is  reasonably 
comprehensive.  Many  Federal  organizations  (including  DOD  and  DA)  par- 
ticipate in  preparing  Federal  Standards.  The  underlying  idea  is  to  have 
a distinct  document  or  manual  for  each  type  of  audience  or  user  affected 
by  the  data  system;  the  documents  have  a basic  functional  segregation. 
Noticeably  absent  are  conversion  and  training  manuals.  No  distinction 
is  made  between  systems  integration  and  prototype  testing. 
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Table  1 


Automated  Data  Processing  System  (ADPS)  Documentation  Standards* ** 


Planning  and  Definition  Phase 


OPP  ##Organization  and  Personnel  Plan 
DFSR  + Detailed  Functional  Sys  Requiremnt 
PMP  Project  Master  Plan 

Development  Phase 


AR 

DOD 

FIPS 

18-1 

4120. 

17M 

PUB  38 

App.  B 

Fig.2 

-01 

Sec.  3. 

1 

App.  C 

Fig. 2 

-01 

Sec.  3. 

1 

App.  G 

Fig.2 

-01 

Sec. 3. 

1 

App.  D 

Fig.2 

-02 

Sec.  3. 

2 

App.M 

Fig.2 

-01 

Sec.  3. 

1 

Hardware  Specification 
System/Subsystem  Specification 
Program  Specification 
Data  Base  Specification 
Systems  Description  Manual 
+ Functional  User  Manual 
+ Program  Description  (Maint)  Manual 
+ Operators  Manual  (Run  Book) 
Conversion  Manual 
+ Training  Manual 

System  Integration  Test  Plan 
Prototype  Evaluation  Test  Plan 
System  Integration  Test  Report 
Prototype  Evaluation  Test  Report 
++ADPE  Readiness  Review  Report 
System  Extension  Plan 


lApps.  J.Kl 
Tabl.  2-1 
Tabl.  2-1 
Tabl,  2-1 
[App. H 
App.  H 
App.  H 
App.  H 

fChT^  ! 


Par.  2-19 
Par. 2-20 
Par. 2-22 
Tabl.  2-1 


Instal lation,  Operation,  and  Maintenance  Phase 

AOPREP  ADP  Resource  Estimating  Procedures  App.  Q 

System  Extension  Report  Tabl.  2-1 

System  Completion  Report  Tabl.  2-1 


Fig. 2-03  Sec.  3.3 
Fig. 2-04  Sec.  3.4 
Fig.  2-051  Sec.  3.5 

Fig.  2-06  Sec.  3.6 
Fig.  2-08  Sec.  3.8 
Fi^2-07  Sec.  3.7 


Fig.  2-091  Sec.  3 . 9 
(Fig.  2- 10 1 Sec.  3.10 


* Boxed  references  are  considered  definitive. 

**  Submit  update  with  GFSR. 

# Submit  update  with  DFSR,  SIT  Report  (Class  B Systems  only),  PET 
Report  (Class  A Systems  only),  and  when  MISEA  estimates  vary  25 
percent  from  operational  experience  or  major  system  changes  occur. 

##  Submit  update  with  updated  MISEA. 

+ Principal  components  of  SDP,  System  Development  Package. 

++  Required  only  for  major  hardware  acquisitions  (Class  A). 
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DOD  4120. 17M 


DOD  4120. 17M,  Automated  Data  Syeteme:  Documentation  Standards 
Manual,  prepared  by  the  Headquarters,  U.S.  Air  Force  (HQ  USAF),  is  simi- 
lar in  outline  to  FIPS  PUB  38  but  is  more  specific.  For  all  practical 
purposes,  this  document  can  be  used  in  lieu  of  FIPS  PUB  38.  DA  par- 
ticipates in  preparing  DOD  standards;  HQ  USAF  has  the  DOD  standards  mis- 
sion. 


AR  18-1 

AR  18-1,  Management  Information  Systems:  Policies,  Objectives, 
Procedures,  and  Responsibilities,  prepared  by  OCSA,  supplements  DOD 
4120. 17M  and  FIPS  PUB  38.  Generally,  FIPS  must  be  incorporated  into  all 
new  automated  data  processing  systems  designs,  or  major  system  change 
efforts,  unless  a request  for  specific  waiver  submitted  through  HQDA  is 
approved.  Federal  standards  on  data  elements  and  codes  and  on  COBOL  are 
waived  in  favor  of  DOD  standards  (AR  18-1,  Par.  1-9).  Federal  and  DOD 
standards  adopted  by  DA  are  not  reprinted  in  Army  publications.  The 
tone  of  AR  18-1,  which  can  be  used  as  a supplement,  is  different  from 
that  of  higher  level  standards.  For  example,  resources  definition 
requirements  are  emphasized  much  more  in  AR  18-1  than  in  Federal  and  DOD 
standards.  At  the  lower  (Army)  level,  there  is  a great  concern  and  a 
great  need  to  be  specific  about  resources  such  as  time  (PMP,  SEP),  funds 
(MISEA,  lease  versus  purchase  requirements,  ADP  contract  services),  man- 
power (OPP,  training,  SEP),  and  materiel  (ADPE  justification  and  speci- 
fications). There  is  also  concern  for  being  specific  about  purpose, 
justification,  and  impact  (GFSR,  MISEA,  OPP). 

The  DFSR  is  nominally  a planning  and  definition  document  but  is 
seen  to  have  aspects  of  specifications  documents.  For  straightforward 
file  maintenance  information  storage  and  retrieval  programs,  the  DFSR 
essentially  is  the  software  specification.  It  is  probably  for  that 
reason  that  the  AR  recognizes  a need  for  software  specifications  down- 
stream from  the  DFSR,  but  says  little  about  it. 


AR  18-7 

AR  18-7,  Management  Information  Systems:  Data  Processing  Installa- 
tion Management,  Procedures,  and  Standards,  by  U.S.  Army  Computer  Sys- 
tems Support  and  Evaluation  Agency  (USACSSEA),  supplements  AR  18-1.  It 
prescribes  standards  for  flowcharts  (Figs.  5-1  through  5-3,  App.  F), 
multiple  card  layouts  (DA  Form  3165,  App.  G),  tape  layouts  (DA  Form 
3166,  App.  H),  multipurpose  code  sheets  (DA  Form  3167,  App.  I),  record 
layouts  (DA  ^orm  3493-R,  App.  K),  Computer  Program  Folder  (App.  J),  and 
Scientific  Computer  Program  Folder  (App.  M).  The  program  folders  pre- 
scribe a procedure  for  filing  documentation  as  it  accumulates. 
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AR  18-12 


AR  18-12,  Marh'i.u'mpnt  Information  Systems:  Catalog  of  Standard  Data 
Elements  and  Codes,  by  OCSA,  is  supported  by  11  volumes  which  usually 
pertain  only  to  certain  Army-wide  file  maintenance  information  storage 
and  retrieval  programs.  It  contains  code  tables  for  general  adminis- 
tration, financial  administration,  mobilization  and  forces,  personnel, 
logistics,  jrocurement,  security  and  intelligence,  troop  program  se- 
quence numbers,  inventory  of  data  systems,  security  measures  applica- 
ble to  RDTE  (research,  development,  test,  and  evaluation),  and  automated 
supply  system. 


CSCM  18-1 


CSCM  18-1,  Automated  Data  Pvoaeseing  System  Development,  Mainte- 
ruinee,  and  Documentation  Standards  and  Procedures  Manual,  Vol.  I,  Gen- 
eral, by  U.S.  Army  Computer  Systems  Command,  is  a useful  supplement  to 
the  preceding  documents.  The  treatment  of  flowcharting,  decision 
tables,  and  technical  documentation  is  comprehensive.  The  documentation 
requirements  are  good  checklists  and  the  training  package  standards  can 
be  considered  definitive.  The  point  of  view  is  file  maintenance  infor- 
mation storage  and  retrieval.  Weaknesses  are  in  the  areas  of  conversion 
and  testing.  Administrative  documentation  relating  to  resource  manage- 
ment (time,  funds,  manpower,  materiel)  and  its  underlying  philosophy  are 
not  prescribed,  but  are  included  as  reference  material.  Strengths  are  in 
system/subsystem/program/data  base  specifications  and  system/ user /main- 
tenance/operators/training manual s. 


ETL  1110-1-45 

ETL  1110-1-45,  Engineeri-ng  and  Design:  Engineering  Computer  Pro- 
gram Library,  Standards  and  Documentation,  by  the  U.S.  Army  Corps  of 
Engineers  Directorate  of  Civil  Works  (OAEN-CW),  is  concerned  with  the 
minimal  amount  of  residual  documentation  to  be  archived.  The  proponent, 
DAEN-CW,  is  concerned  with  a large  body  of  predominantly  engineering  and 
scientific  FORTRAN  programs  to  be  stored  at  a library  maintained  by  the 
U.S.  Army  Engineer  Waterways  Experiment  Station,  Vicksburg,  MS.  Con- 
sequently, the  outlook  of  ETL  1110-1-45  is  vastly  different  from  the 
administrative,  technical,  and  file  management-oriented  Federal,  OOD, 
and  DA  requirements.  ETL  1110-1-45  asks  for  three  things;  (1)  ENG  Form 
2883,  Electronic  Computer  Program  Abstract,  (2)  program  description-- 
both  engineering  description  (engineering/mathematical  theory)  and  com- 
puter functional  description  ( user /operator  manual ) , and  (3)  file  docu- 
mentation (maintenance  manual). 
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USACERL 


The  USACERL  Docimentation  Manual,  prepared  by  McDonnell  Automation 
for  the  U.S.  Army  Construction  Engineering  Research  Laboratory,  Cham- 
paign, IL,  is  oriented  toward  technical  documentation  and  introduces  the 
idea  of  controlling  documentation  through  standardized  forms.  The  main 
sections  are;  (1)  system  documentation  (system  and  data  definition, 
setup,  and  control),  (2)  program  documentation  (program  definition,  setup 
and  processing,  listings  and  displays),  (3)  input  procedures,  and  (4) 
data  communications.  The  manual  is  not  comprehensive  but  does  contain 
an  extensive  glossary  of  data  communications  terms.  The  manual  does 
give  insight  to  standards  used  by  a major  private  software  firm. 


Commercial 


The  Manual  of  Computer  Docimentation  Standavde  with  Forme,  by 
Kuehne,  Lindberg,  and  Baron,  is  a commercial  standard  which  uses  stan- 
dardized forms  and  checklists  as  much  as  possible.  Comprehensiveness  is 
sought  and  achieved  to  a great  extent  by  the  phases  of  feasibility 
study,  system  design,  programming,  testing,  implementation,  and  oper- 
ation. Cost,  equipment,  and  project  scheduling  data  are  compiled,  but 
cost  benefits  and  organizational  impact  data  are  not.  This  document  is 
worthwhile  as  an  organizational  document  for  someone  beginning  a new 
project. 
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4 TRENDS  AND  FUTURE  STANDARDS 


Genet  a1 

Documentation  standards  are  evolving  rapidly  and  continuously  and 
are  likely  to  do  so  for  some  time.  The  reasons  lie  in  the  phenomenal 
data  processing  growth  of  the  past  quarter  century.  Increasing  complex- 
ity and  financial  outlays  are  accompanied  by  a need  to  exert  some  con-  ; 

trol  over  data  processing,  and  by  a need  to  manage  effectively.  Docu-  ! 

mentation  is  a principal  means  of  control.  Data  processing  is  not  j 

sufficiently  developed  for  a stable  document  control  philosophy  to  j 

emerge;  however,  existing  standards  are  sufficiently  developed  to  pro-  \ 

vide  reliable  guidance.  A good  example  of  change  is  AR  18-1.  An  ear-  | 

lier  version  (4  August  1971)  lasted  4-1/2  years  (until  22  March  1976).  v 

The  current  version  is  being  revised,  as  discussed  below.  { 

I 

Planned  AR  18-1  Revisions 

The  current  AR,  209  pages,  is  a mixture  of  high-level  policy  and 
minute  procedural  detail.  Policy  does  change,  but  not  rapidly,  and  the 
body  of  codified  policy  does  not  grow  appreciably.  On  the  other  hand, 
procedural  details  have  experienced  a characteristically  rapid  mutation 
and  growth.  But  an  AR,  having  substantial  Army-wide  impact,  is  not 
easily  or  quickly  modified  when  the  need  arises.  The  chosen  solution 
to  this  problem  has  been  to  subdivide  the  AR.  The  basic  AR  (poli- 
cies, responsibilities,  and  delegations  of  authority)  will  be  a short, 
relatively  invariant  document.  The  detailed  procedures  will  consist  of 
a number  of  technical  bulletins  (currently  23)  which  can  be  changed  rel- 
atively easily  (see  Table  2).  The  new  draft  of  AR  18-1  was  scheduled  to 
be  completely  reviewed  by  5 December  1977,  and  TB  18-122,  Software  Con- 
version Planning,  which  fills  a long  standing  need,  was  being  printed  in 
December  1977.  Some  other  TB's  are  currently  in  draft  form,  while 
others  exist  in  name  only.  No  TB's  were  published  as  of  1 December 
1977. 


Other  Standards  Revisions 


Current  Federal  and  Department  of  Defense  standards  are  relatively 
recent  and  may  not  change  substantially  for  awhile.  An  outline  of  some 
changes  to  DA  standards  was  given  in  the  preceding  paragraph;  other 
changes  may  be  expected.  Organizational,  personnel,  and  technological 
changes  result  in  the  reevaluation  of  standards.  For  example,  the  U.S. 
Army  Computer  Systems  Command  (CSC)  has  a responsibility  for  defining 
standards  for  Army-wide  ( mu 1 ti command)  computer  applications.  If  CSC  is 
given  Army-wide  responsibility  for  documentation  standards,  considerable 
changes  may  be  expected.  Corps-wide  standards  have  not  changed  since 
1971,  and  no  major  changes  are  known  to  be  planned. 
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Table  2 


Planned  AR  18-1  Revisions 


New  AR  18-1  Content 


Chapter  1 General 

Chapter  2 Automation  Policies 

Chapter  3 Responsibilities 

Chapter  4 System  Classification  and  Delegation  of  Authority 
Appendix  A Terms  and  Abbreviations 


Supporting  Technical  Bulletins 


TB 

18- 

100 

TB 

18- 

101 

TB 

18- 

102 

TB 

18- 

103 

TB 

18- 

104 

TB 

18- 

105 

TB 

18- 

106 

TB 

18- 

107 

TB 

18- 

108 

TB 

18- 

109 

TB 

18- 

110 

TB 

18- 

111 

TB 

18- 

112 

TB 

18- 

113 

TB 

18- 

114 

TB 

18- 

115 

TB 

18- 

116 

TB 

18- 

117 

TB 

18- 

118 

TB 

18- 

119 

TB 

18- 

120 

TB 

18- 

121 

TB 

18- 

122 

TB 

18- 

123 

TB 

18- 

124 

Life  Cycle  Model 

Master  Planning 

Requirement  Documents 

Software  Design  and  Development 

Testing  of  Systems 

(Undesignated) 

System  Extension 
System  Operation 
Maintenance  and  Modification 
Economic  Analysis 
Configuration  Management 
Technical  Documentation 
Training  Management 
(Undesignated) 

Performance  Measurement  and  Analysis 
Army  Information  Processing  Standards 
Resource  Estimating  Techniques 
Interface,  Operability,  and  Integration 
Acquisition  of  Equipment,  Software,  and  Services 
Telecommunication  Support 
Battlefield  Automation  Support 
Scientific  and  Engineering  Applications 
Software  Conversion  Planning 
Quality  Assurance 

Army  Automation  Financial  Management 
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5 RESULTS,  CONCLUSIONS,  AND  RECOMMENDATIONS 


Resul ts 

Nine  significant  government  and  commercial  documentation  standards 
nave  been  reviewed,  evaluated,  and  compared.  Approximately  two  dozen 
major  types  of  documents  were  seen  to  be  required;  these  are  classified 
in  Chapter  2 and  listed  by  major  source  in  Table  1.  Table  2 lists  major 
anticipated  revisions  to  documentation. 


Conclusions 

Existing  Federal,  DOD,  and  DA  documentation  standards  are  suf- 
ficiently developed  to  serve  as  reliable,  comprehensive  guidance. 

No  single  source  document  is  an  adequate  standard;  however,  as  a 
foundation,  one  might  use  DOD  4120. 17M,  AR  18-1,  TB  18-122.  and  CSCM  18- 
1 (Training  Package). 


Recommendations 

DOD  4120.17M,  AR  18-1,  TB  18-122,  and  CSCM  18-1  (Training  Package) 
should  be  used  as  initial  guidelines  for  preparing  Table  1 documentation 
tor  both  the  CAEADS  system  and  individual  CAEADS  subsystems.  References 
boxed  in  Table  1 are  considered  most  definitive  but  not  necessarily  com- 
prehensye;  best  results  can  be  obtained  by  using  more  than  one  source 


REFERENCES 


(Arranged  in  order  of  appearance  in  text) 


Federal  Government  Standards 

FIPS  PUB  38,  Gui dp.lime  for  Documentation  of  Computer  Programs  and 
Automated  Data  Systems  (U.S.  Uept.  of  Commerce/National  Bureau 
of  Standards,  15  February  1976). 

Department  of  Defense  Standards 

DOD  4120. 17M,  Automated  Data  Systems-  Documentation  Standards 
Manual  (Hq  U.S.  Air  Force,  October  1975). 

Department  of  the  Army  Standards 

AR  18-1,  Management  Information  Systems:  Policies,  Objectives, 

Procedures,  and  Responsibilities ; Par  2-20c  (System  Development 
Package  content);  Ch.  8,  "Training  Management  for  Class  A-1 
Systems";  and  App.  H,  "Data  Processing  Installation  Systems 
Document  Requirements."  Also  Apps.  B,  C,  0,  G,  J,  K,  M,  N 
(Department  of  the  Army,  22  March  1976). 

AR  18-7,  Management  Information  Systems:  Data  Processing 

Installation  Management,  Procedures,  and  Standards,  Ch.  5 
"Documentation";  App.  J,  "Computer  Program  Folder";  and  App.  M, 
Scientific  Computer  Program  Folder"  (Department  of  the 
Army,  29  September  1966). 

AR  18-12,  Management  Information  Systems:  Catalog  of  Standard  Data 
Fdements  and  Codes  (Department  of  the  Army,  29  March  1974). 

CSCM  18-1,  Automated  Data  Processing  System  Development, 

Mat ntenance,  and  Documentation  Standards  and  Procedures  Manual, 
Vol  I,  General,  Ch.  6,  "Documentation  Standards  " (Computer 
Systems  Command,  Department  of  the  Army,  15  March  1974). 

Corps  of  Engineers  Standards 

ETL  1110-1-45,  Engineeri.ng  and  Design:  Engineerina  Computer 

Program  Library,  Standards  and  Documentation  tOffice  of  the 
Chief  of  Engineers,  Department  of  the  Army,  9 February  1971). 

USACERL,  Documentation  Manual  (McDonnell  Automation  [MCAUTO] 
for  the  U.S.  Army  Construction  Engineering  Research 
Laboratory,  5 December  1975). 
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Connnerclal  Standards 


d 


Kuehne,  R.  S.,  H.  W.  Lindberg,  and  W.  F,  Baron,  Manual  of  Computer 
Documentation  Standards  with  Forme  (Prentice-Hall,  Inc.,  1972). 


APPENDIX; 


DOCUMENTS  AND  CONTENTS  BY  SOURCE 


CONTENTS 


1.  FUNCTIONAL  REQUIREMENTS  DOCUMENT 

2.  DATA  REQUIREMENTS  DOCUMENT 

3.  SYSTfm/SUBSYSTEM  SPECIFICATION 

4.  PROGRAM  SPECIFICATION 

5.  DATA  base  SPECIFICATION 
A,  FUNCTIONAL  USER  MANUAL 

7.  OPERATIONS  MANUAL  (RUN  BOOK) 

P.  PROGRAM  MAINTENANCE  MANUAL 

9.  TEST  plan 

10.  test  ANALYSIS  REPORT 

11.  systems  DESCRIPTION  MANUAL 

1?.  CONVERSION  MANUAL  (MANUAL  TO  MACHINE) 


NOTATION 


CARD  HEAD 

COLS  INGS  SOURCE  DOCUMENTS 


48 

50 

5? 


58 

60 


EED  EIPS  PUR  38*  GUIDELINES  FOR  DOCUMENTATION  OF 

COMPUTER  PROGRAMS  AND  AUTOMATED  DATA  SYSTEMS  (U.S. 
DEPT.  OF  COMMERCE/NATIONAL  BUREAU  OF  STANDARDS. 
1976)  . 

DOO  DOD  41P0.17  M»  AUTOMATED  DAT^  SYSTEMS:  nOCUMENTA- 
TION  STANDARDS  MANUAL  (HQ  U.S.  AIR  FORCE.  1975). 
DAI  AR  18-1.  MANAGEMENT  INFORMATION  SYSTEMS:  POLICIES. 
OBJECTIVES.  PROCEDURES.  AND  RESPONSIBILITIES!  PAR. 
2-20C  (SYSTEM  DEVELOPMENT  PACKAGE  CONTENT)!  CH.  8. 
"TRAINING  MANAGEMENT  FOR  CLASS  A-1  SYSTEMS"!  AND 
APP.  H.  "DATA  PROCESSING  INSTALLATION  SYSTEMS 
documentation  REQUIREMENTS".  (ALSO.  APpS.  B.C.D. 
G.J.K.M.Q.) 

CPR  CONVERSION  INSTRUCTIONS  EOR  THE  AUTOMATED  MILITARY 
CONSTRUCTION  PROGRESS  REPORTING  SYSTEM  (AMPRS). 
TECHNICAL  REPORT  P-51  (U.S.  ARMY  CONSTRUCTION 
ENGINEERING  RESEARCH  LABORATORY.  1975). 

FUA  CORPS  OE  ENGINEERS  MANAGEMENT  INEORMATION  SYSTEM: 
COEMTS  EiA  SUBSYSTEM  CONVERSION  MANUAL  (OFEICE. 
CHIEE  OF  ENGINEERS.  1972). 
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1.  FUNCTIONAL  REQUIREMENTS  DOCUMENT  XXX 

1.  general  INFORMATION  X X X 

1,  SYSTEM  title  X 

2,  SYSTEM  CLASSIEICATION  X 

3,  PURPOSE  OF  FUNCTIONAL  DESCRIPTION  XXX 

1.  SYSTEM  REQUIREMENTS  X X 

?.  PERFORMANCE  REQUIREMENTS  X 

3.  SYSTEM  tests  X 

4,  ASSUMPTIONS  X 

5,  constraints  X 

6,  SECURITY  REQUIREMENT  X 

7,  PROJECT  CONTROL  X 

0,  AUTOMATION  LEVEL/CONCEPT  X 

9,  SYSTEM  ABSTRACTS  X 

1.  SYSTEMS  TITLE  X 

?.  SYSTEMS  STATUS  X 

3.  PROPONENT  AGENCY  X 

4.  ASSIGNED  RESPONSIBLE  AGENCY  X 

5.  AUTHORIZATION  DIRECTIVE  X 

6.  general  DESCRIPTION  OF  SYSTEM  X 

7.  SYSTEMS  OBJECTIVES  X 

0.  AOPE  CONFIGURATION  X 

9,  DATA  PROCESSING  INSTALLATIONS  X 

10.  SYSTEMS  interface  X 

11,  DATA  COMMUNICATIONS  X 

10,  ENVIRONMENT-ORGANIZATIONAL  X X 

11,  PROJECT  REFERENCES  XXX 

1,  PROJECT  REQUEST  X X 

?,  PREVIOUS  TECHNICAL  DOCUMENTATION  X X 

3,  DOCUMENTATION  OF  RELATED  PROJECT  X X 

4,  other  reference  documents  XXX 

5,  formal  agreements  X 

0.  reference  DOCUMENTATION  X 

1.  DOCUMENTATION  STDS  AND  SPECS  X 

?,  programming  CONVENTIONS  X 

3.  federal  standards*  000  STDS  X 

4,  hardware  manuals  X 

12,  TERMS  AND  ABBREVIATIONS  APPENDIX  X X 

2,  system  SUMMARY  XXX 

1 , BACKGROUND  XXX 

2,  OBJECTIVES  XXX 

3,  EXISTING  methods  AND  PROCEDURES  XXX 

1.  ORGANIZTN/PERS  RESPONSIBILITIES  X X X 

2.  EQUIPMENT  AVAltABLE  AND  REQUIRED  XXX 

3.  VOL/FREOUENCY  OF  INPUT/OUTPUT  XXX 

4.  DEFICIENCIES  AND  LIMITATIONS  X X 

5.  PERTINENT  COST  CONSIDERATIONS  X 

0,  DATA  Flow  x x x 
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♦,  PROPOSED  METHODS  AND  PROCEDURES  X X X 

1.  0R6ANIZTN/PERS  RESPONSIBILITIES  X X 

?.  EQUIPMENT  AVAILABLE  AND  REQUIRED  X X 

3.  VOL/FREQUENCY  OF  INPUT/OUTPUT  X X 

A.  OFFICIENCIES  AND  LIMITATION*;  X 

5.  PERTINENT  COST  CONSIDERATIONS  X 

DATA  flow  XXX 

5.  SUMMARY  OF  IMPROVEMENTS  X X 

I.  NEW  CAPABILITIES  X X 

?.  UPGRADED  EXISTING  CAPABILITIES  X X 

3.  ELIM  OF  existing  DEFICIENCIES  X 

A.  improved  timeliness  X X 

5.  elimination  or  REDUCTION  OF  EX- 
ISTING CAPABILITIES  X X 

6.  summary  of  impacts  XXX 

I.  EQUIPMENT  IMPACTS  (ADDNS,  MODS)  XXX 

?.  SOFTWARE  IMPACTS  (ADDNS.  MODS)  X X 

3.  ORGANIZATIONAL  IMPACTS  XXX 

1.  FUNCTIONAL  REORGANIZATION  X X 

P.  TNCREASE/DECREASE  STAFF  LEVEL  XXX 

(FST  MIL/CIV  MANPWR  SPACE  REOS)  X 

1.  CURRENT  organization-available 
MANPOWER  X 

1.  DPI  OPERATOR/MAINT  PERS  X 

?.  DPI  SUPPORT  PERSONNEL  X 

3.  OTHER  SUPPORT  PERSONNEL  X 

A.  TOTAL  AVAILABLE  MANPOWER 

SPACES  X 

?.  ESTIMATED  MANPOWER  PEQS  X 

1,  DPI  OPERATOR/MAINT  PERS  X 

2,  DPT  SUPPORT  PERSONNEL  X 

3,  OTHER  SUPPORT  PERSONNEL  X 

A,  TOTAL  MANPOWER  SPACE  REQ  X 

3.  PLANNED  ORGANIZATIONAL  CHANGES  X 
A.  RECAPITULATION  X 

1.  AVAILABLE  MANPOWER  X 

2.  ESTIMATED  REQUIREMENTS  X 

3.  ORGANIZATIONAL  CHANGES  X 

A.  IMPACT  OF  CHANGES  X 

3.  UP/OOWN6RAOE  OF  STAFF  SKILLS  X X X 

(PEPS  AND  MOS  OISTRIB  BY: 

CATEGORY*  MOS/CIV  CODE*  GRADE. 

BRANCH*  CURR  AUTH.  EST  REQ*  NET 
CHANGE)  X 

1,  DPI  OPERATOR/MAINT  PERS  X 

2,  DPI  SUPPORT  PERSONNEL  X 

3,  OTHER  SUPPORT  PERSONNEL  X 

A.  PLANNED  ORGANIZATIONAL  CHANGES  X 
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5.  RECAPITULATION  X 

A.  OPERATIONAL  IMPACTS  X X 

1,  STAFF/OPERATIONAL  PROCEDURES  X X 
?.  RELATIONSHIPS  BETWEEN  THE  OP- 
ERATING CENTER  AND  THE  USERS  X X 

3.  OPERATING  CENTER  PROCEDURES  X X 

A,  DATA  (SOURCES*  VOLUME*  MEDIUM* 

TIMELINESS)  X X 

5.  DATA  RETENTION/RETRIEVAL  PROCS  X X 

6.  REPORTING  METHODS  X X 

7.  SYSTEM  FAILURE  CONSEQUENCES 

AND  RECOVERY  PROCEDURES  X X 

8.  DATA  INPUT  PROCEDURES  X X 

9.  COMPUTER  PROCESSING  TIME  REGS  X X 

5.  DEVELOPMENTAL  IMPACTS  X X 

1.  USER  SUPPORT  OF  SOFTWARE  DEVEL  X X 

2.  DATA  BASE  DEVEL  RESOURCES  X X 

3.  COMPUTER  PROCESSING  RESOURCES 

TO  DEVELOP  AND  TEST  SOFTWARE  X X X 

7.  EXPECTED  LIMITATIONS  X X 

1.  LIMITATIONS  ON  DESIRED  CAPABIL- 
ITIES X 

2.  expected  types  OF  ERRORS  X 

8.  OTHER  CONSIDERATIONS  X X 

1.  COST  X 

2.  interfaces  X X 

3.  telecommunication  X 

9.  alternative  proposals  X X 

3.  DETAILED  CHARACTERISTICS  XXX 

1,  SPECIFIC  PERFORMANCE  REGS  XXX 

1.  ACCURACY  AND  VALIDITY  X X 

1.  MATHEMATICAL  X X 

2.  LOGICAL  X X 

3.  LEGAL  X X 

A.  TRANSMISSION  X X 

?.  TIMING  X X 

1.  THROUGHPUT  TIME  X X 

2.  RESPONSE  TIME  TO  QUERIES  AND 

TO  UPDATES  OF  DATA  FILES  X X 

3.  major  FUNCTION  RESPONSE  TIME  X X 

A.  FUNCTIONS  SEQUENTIAL  RELATIONS  X 

5.  INPUT/OPERATIONS  PRIORITIES  X 

6.  timing  RFQS  for  THE  RANGE  OF 

TRAFFIC  LOAD  X 

7.  DATA  TRANSFER/TRANSMIT  TIME  X X 

8.  INTERLEAVING  REQUIREMENTS  X 

3.  flexibility  X X 

1.  PRIORITIES  IMPOSED  BY  TYPES 
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OF  INPUTS  AND  CHANGES  IN 
MODES  OF  OPERATION  XXX 

?.  OPERATING  ENVIRONMENT  XXX 

3.  INTERFACES  WITH  OTHER  SOFTWARE  XXX 

4.  ACCURACY/VALIDATION  TIMING  X X 

5.  planned  CHANGESt  IMPROVEMENTS  X X 

2.  system  FUNCTIONS  X X 

1.  ADS  FUNCTIONS  DESCRIPTION  X X 

2.  FUNCTIONS  SATISFACTION  OF  PER- 
FORMANCE REQUIREMENTS  X X 

3.  INPUTS/OUTPUTS  X X 

1.  EXAMPLES  AND  EXPLANATIONS  OF  I/O  X X 

2.  SPECS  OF  THE  MEDIUM  (DISK,  CARDS 
magnetic  TAPE),  FORMAT,  RANGE  OF 

values,  and  accuracy  X X 

3.  examples  of  hard  copy,  graphic, 

OR  DISPLAY  REPORTS  X X 

4,  data  CHARACTERISTICS  X X 

1.  DESCRIPTION  OF  INDIVIDUAL  AND 
COMPOSITE  DATA  ELEMENTS  BY  NAME, 

CODES,  DICTIONARIES,  TABLES,  AND 

reference  files  X X 

2.  ESTIMATE  OF  TOTAL  DATA  STORAGE 

PEGS,  EXPECTED  GROWTH  X X 

5,  FAILURE  CONTINGENCIES  XXX 

1.  BACK-UP  X X 

2.  fallback  X X 

3.  RECOVERY  AND  RESTART  X X 

4.  operating  ENVIRONMENT  X X X 

1.  EQUIPMENT  X X 

1.  PROCESSORS,  INTERNAL  STORAGE  X X 

2.  STORAGE  MEDIA  X X 

3.  output  devices  X X 

4.  INPUT  DEVICES  X X 

5.  DATA  transmission  X X 

2.  SUPPORT  SOFTWARE  X X 

3.  INTERFACES  XXX 

1.  EXTERNAL  INTERFACE  X 

2.  PURPOSE/REQUIREMENT  X 

3.  EXCHANGE  VEHICLE  X 

4.  ECHELON  INTERFACE  AND  FEEDBACK  X 

5.  CONSTRAINTS  X 

6.  interface  event  X 

7.  FREQUENCY  OF  INTERFACE  X 

8.  SECURITY  CLASSIFICATION  X 

q,  REMARKS  X 

4.  SECURITY  AND  PRIVACY  X X 

5.  CONTROLS  X 
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5.  SYSTEM  DEVELOPMENT  PLAN  XXX 

(PROJECT  MASTER  PLAN)  X 

1.  TITLE  X 

1.  REFERENCES  XXX 

2.  ORGANIZATION  X 

2.  PROJECT  DESCRIPTION  X 

1.  BACKGROUND  X 

2.  GENERAL  DESCRIPTION  X 

3.  OBJECTIVES  X 

A.  constraints  X 

5.  PARTICIPATIONG  ORGANIZATIONS  XXX 

6.  ASSUMPTIONS  X 

3.  OBJECTIVE  X 

♦.  EXECUTION  X 

1.  CONCEPT  OF  OPERATION  XXX 

2.  SPECIFIC  TASKS  X 

3.  COORDINATING  INSTRUCTIONS  X 

5,  RESOURCE  SUPPORT  X 

6,  POINTS  OF  CONTACT  X 

7,  ANNEXES  X 

1.  SUMMARY  TECH  APPROACH  AND  RISKS  X 

2.  summary  work  ORGANIZATION  CHART  X 

3.  SUMMARY  SCHEDULE  CHART  XXX 

A.  SUMMARY  MANPOWER  LOADING  CHART  X 

S,  SUMMARY  FINANCIAL  SUPPORT  CHART  X 

6.  COST  FACTORS.  ECONOMIC  ANALYSIS  X X 

1.  PROBLEM/OPPORTUNITY  ID  X 

2.  RELEVANT  ENVIRONMENT  X 

3.  OBJECTIVES  X 

A,  assumptions/constraints  X 

1,  REQUIREMENTS  OF  HIGHER  COMMAND  X 

2,  SECURITY  X 

3,  TELECOMMUNICATIONS  t 

A,  interface  with  OTHER  SYSTEMS  X 

5.  ALTERNATIVES  X 

5.  alternatives  X 

6.  COSTS  X 

1 . PERSONNEL  X 

2.  HARDWARE  X 

3.  SOFTWARE  X 

A.  FACILITIES  X 

5.  COMMUNICATIONS  X 

7.  BENEFITS  X 

8.  COMPARE  ALTERNATIVES  X 

9.  SENSITIVITY  TEST  X 

10.  ANALYSIS  PRESENTATION  X 

7.  communication  REOS  X 

8.  Training  reos  x 
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DATA  REQUIREMENTS  DOCUMENT  XXX 

1.  GENERAL  INFORMATION  XXX 

1.  PURPOSE  OF  DATA  REQS  DOCUMENT  X X 

2.  ENVIRONMENT-ORGANIZATIONAL  X 

3.  PROJECT  REFERENCES  XXX 

1.  PROJECT  REQUEST  (AUTHORIZATION)  X X 

2.  PREVIOUS  DOCUMENTS  X X 

3.  DOCUMENTATION  OF  RELATED  PROJECT  X X 

4.  FIPS  PUBSf  OTHER  REF  DOCS  X 

5.  FUNCTIONAL  DESCRIPTION  X 

4.  TERMS  AND  ABBREVIATIONS  X X 

5.  MODIFICATION  OF  DATA  REQUIREMENTS  X X 

2.  Data  description  x x x 

1.  static  system  DATA  XXX 

2.  DYNAMIC  INPUT  DATA  XXX 

3.  DYNAMIC  OUTPUT  DATA  X X X 

4.  internally  GENERATED  DATA  XXX 

5.  SYSTEM  DATA  CONSTRAINTS  X X X 
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